home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / space102.arc / SPACE.DOC
Encoding:
Text File  |  1986-12-06  |  6.0 KB  |  199 lines
  1.         SPACE.EXE v1.02                                  by Jeff Porter
  2.  
  3.  
  4.                           SPACE          The Disk Space Analyzer
  5.  
  6.  
  7.         INTRODUCTION
  8.  
  9.              Designed primarily for hard disk users,  SPACE.EXE  analyzes 
  10.         file  sizes and determines the amount of disk space wasted by the 
  11.         disk  storage allocation techniques used  by  MS-DOS.   SPACE.EXE 
  12.         produces  a report that can be used in making decisions regarding 
  13.         the most effective ways to use a disk.  
  14.  
  15.  
  16.         BACKGROUND
  17.  
  18.              Because DOS allocates space for files in disk storage  units 
  19.         called clusters,  it is possible for a short file to consume much 
  20.         more disk space than the directory entry indicates.   The size of 
  21.         a  disk cluster varies from 512 to 8192 bytes,  depending on  the 
  22.         type  of disk.   On a 20 megabyte hard disk,  the cluster size is 
  23.         8192  bytes,  meaning  that the storage space for  all  files  is 
  24.         rounded up to the next 8192 multiple.  Thus, a 45 byte file would 
  25.         take  8192 bytes of disk space,  a 8192 byte file would use  8192 
  26.         bytes of disk space,  and a 20,000 byte file would require 24,576 
  27.         bytes  of  disk  space.   On a 10 megabyte hard  disk,  space  is 
  28.         allocated  in 4096 byte increments,  causing the 45 byte file  to 
  29.         consume 4096 bytes, the 8192 byte file to consume 8192 bytes, and 
  30.         the 20,000 byte file to consume 20,480 bytes of disk space.  
  31.  
  32.              If there are many small files on a hard disk,  a significant 
  33.         amount of space may be wasted.   A program that analyzes the file 
  34.         sizes   and  determines  how  much  space  is  wasted  would   be 
  35.         worthwhile.   It would help users make decisions as to if or when 
  36.         action  should to be taken to correct the problem of wasted space.  
  37.         The program SPACE.EXE was written for this purpose.  
  38.  
  39.  
  40.         USING SPACE.EXE
  41.  
  42.              The program SPACE.EXE will process the directories of a hard 
  43.         disk and give a report indicating:
  44.  
  45.              o    The total number of files
  46.              o    The total amount of disk space used
  47.              o    The actual amount of space used by the data within the 
  48.                        files -- a sum of the file sizes.
  49.              o    The amount of space wasted because of the clustering 
  50.                        method.
  51.              o    The percentage of wasted space, determined by the ratio 
  52.                        of the total disk space used to the total space 
  53.                        wasted.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         SPACE.EXE v1.02                                  by Jeff Porter
  68.  
  69.  
  70.         To run the program, just use the command:
  71.  
  72.         C>SPACE \*.*
  73.  
  74.         All  the  files in the root directory and in  all  subdirectories 
  75.         will  be  processed.   To analyze the space  utilization  of  the 
  76.         current directory and all of its subdirectories, use the command:
  77.  
  78.         C>SPACE *.*
  79.  
  80.         To find the space utilization of the current directory only, 
  81.         use:
  82.  
  83.         C>SPACE *.* /n
  84.  
  85.         To analyze a particular directory and its subdirectories, use:
  86.  
  87.         C>SPACE SUBDIR\*.*
  88.  
  89.  
  90.         FULL SYNTAX OF THE SPACE.EXE PROGRAM
  91.  
  92.  
  93.               [d:]SPACE filespec [/N] [/L]
  94.  
  95.  
  96.         The  filespec  SHOULD  contain wildcards and may contain  a  path 
  97.         and/or drive specifier.
  98.  
  99.         filespec is the search filespec to use.   All matching files  and 
  100.         directories  will  be  processed.   Commonly used  filespecs  are 
  101.         "*.*",  "\*.*",  and "\SUBDIR\*.*".   If a filespec is similar to 
  102.         the form "*.BAT",  all batch files in the current directory  will 
  103.         be  processed.   No  subdirectories will be searched unless  they 
  104.         match the filespec form of "*.BAT".  Thus, including non-wildcard 
  105.         characters  in  the  filename  position  will  usually  eliminate 
  106.         subdirectories.
  107.  
  108.  
  109.         The options are:
  110.  
  111.         /N        Do not process subdirectories.
  112.  
  113.         /L        List the files and directories as they are processed.  
  114.                   Using this option generally slows the program down a 
  115.                   great deal since many files may be listed.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.         SPACE.EXE v1.02                                  by Jeff Porter
  134.  
  135.  
  136.         SAMPLE RUN
  137.  
  138.         C>SPACE \*.*
  139.         The total of 963 files requires 14950.400 Kbytes
  140.         The data itself requires 9547.853 Kbytes.  5402.547 Kbytes are 
  141.            wasted.
  142.         The percentage of wasted space is 36.14.
  143.         C>
  144.  
  145.  
  146.         The  program produced this space utilization report in less  than 
  147.         25 seconds.
  148.  
  149.  
  150.         REQUIREMENTS
  151.  
  152.  
  153.         This  program requires DOS 2.0 or later.   It is not very  useful 
  154.         for  floppies,  although it will give accurate  results.   Memory 
  155.         requirements are modest; 128K should be enough.
  156.  
  157.  
  158.         PROGRAM HISTORY
  159.  
  160.         The program SPACE.EXE was written during July and August of  1985 
  161.         by Jeff Porter.   It is written in the C language, and the source 
  162.         code is available by special request.  Jeff Porter can be reached 
  163.         on the following Austin area bulletin boards (area code 512):
  164.  
  165.         Deep Thought        244-1598
  166.         Crystal Caverns     263-5805 (Fido 103/50)
  167.         Dead End            255-1282 (Fido 103/91)
  168.  
  169.         or by FidoMail to Freeside, Fido 103/1985.
  170.  
  171.  
  172.         CONTRIBUTIONS
  173.  
  174.  
  175.         If  you think this program is worthwhile,  a contribution of  any 
  176.         amount  of money ($5 is suggested) would be greatly  appreciated.  
  177.         Whether you chose to contribute or not,  please let me if you use 
  178.         SPACE.EXE and let me know of any bugs.
  179.  
  180.         Jeff Porter
  181.         1505 West Creek Loop
  182.         Round Rock, TX 78681
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.